home *** CD-ROM | disk | FTP | other *** search
/ MIDICraft's MIDINET CD-ROM / MIDICraft's MIDINET CD-ROM.iso / DOSUTILS / FINDDBL.DOC < prev    next >
Text File  |  1996-08-10  |  8KB  |  218 lines
  1.         ******************************
  2.           FINDDBL v1.1 (DOS/WINDOWS)
  3.                
  4.           find duplicate binary files
  5.               by Guenter Nagler 
  6.                 1995 
  7.           (gnagler@ihm.tu-graz.ac.at)
  8.         ******************************
  9.  
  10. [1] BACKGROUND
  11. Sometimes I download many news articles form alt.binaries.sound.midi
  12. at once. Then I decode them all together and get a huge mass of midi 
  13. files. To save time from hearing exact songs twice I compare the midi 
  14. files to my personal midi archive and delete the files that are
  15. duplicates.
  16.  
  17. For this purpose see also utility filedb (section [8]) that is capable 
  18. of comparing files with maybe already deleted files!
  19.  
  20. [2] FILES DESCRIPTION
  21.  
  22. FINDDBL.EXE..........MSDOS executable to find duplicates
  23. FINDDBL.DOC..........this file, showing usage of FINDDBL.EXE
  24. only FINDDBL.EXE is required to run program 
  25.  
  26. [3] COPYRIGHT
  27.  
  28. FINDDBL (c) 1995 was created by Guenter Nagler.
  29.  
  30. FINDDBL is free and may be used as you wish with this one exception:
  31.  
  32.     You may NOT charge any fee or derive any profit for distribution
  33.     of FINDDBL.  Thus, you may NOT sell or bundle FINDDBL with any 
  34.     product in a retail environment (shareware disk distribution, CD-ROM,
  35.     etc.) without permission of the author.
  36.  
  37. You may give FINDDBL to your friends, upload it to a BBS, or ftp it to
  38. another internet site, as long as you don't charge anything for it.
  39.  
  40. [4] DISCLAIMER
  41.  
  42. FINDDBL was designed to compare binary files in two directories or two
  43. directory trees. It does not compare files that are hidden, system or 
  44. that are not normal binary files.
  45.  
  46. Use FINDDBL at your own risk.  Anything you do with FINDDBL is your
  47. responsibility, and not the author's.  Any damage caused to any person,
  48. computer, software, hardware, company, or business by running FINDDBL 
  49. is your responsibility, and the author will not be liable.
  50.  
  51. If you don't understand these terms, or are not sure of something, or
  52. are afraid something bad might come of using FINDDBL, don't  use  it!
  53. You are here forewarned.
  54.  
  55. [5] INSTALLATION 
  56.  
  57.   Simply copy FINDDBL.EXE in a directory that is in your path.
  58.   When you start the program without arguments
  59.  
  60.   C:\> FINDDBL
  61.  
  62.   you should get the usage text (see next section)
  63.  
  64. [6] USAGE
  65.  
  66. usage: finddbl [/S][/C][/N] dir1[\[filter]] [dir2][\[filter]]
  67. dir1,dir2:  path of directories to compare (default dir2 is .)
  68. filter:     unix wildcards *,?,[a-z] can be used (default is *.*)
  69. /S:         find duplicate files in subdirectories
  70. /C:         match file content
  71. /N:         match file name
  72. /V:         show version
  73. default options: /C
  74.  
  75. finddbl can be aborted using <ESC> key during searching.
  76. Empty files (length 0) are not considered as duplicates.
  77. finddbl loads table of dir1 and compares the list to files found in dir2.
  78. dir1 should contain less matching files than dir2 that the compare time
  79. is minimal.
  80. When using option /C (match content) finddbl only compares file data if the 
  81. file size of two files is equal. Without specifing option /N the files 
  82. need not to have same filenames, only file data must be identical.
  83.  
  84. These combinations of the options /C and /N do following:
  85. /C      files are considered to be duplicate if their size and content is 
  86.     equal. File date and file names are not compared.
  87.  
  88. /N    files are considered to be duplicate if their filenames are equal
  89.     (name including extension but without path). The file date and file 
  90.     length and file content is not compared.
  91.  
  92. /C /N   (order is not important)
  93.     files are considered to be duplicate if their filenames (exclusive path)
  94.     are equal and their file size are equal and their content is equal.
  95.     File date is not compared.    
  96.  
  97. There are two hidden options to delete duplicates. 
  98. Do not use it if you are not a computer expert!
  99. You are responsible yourself if you delete files using this option!
  100. The program does not ask you before deleting!
  101.  
  102. /Kill1      delete duplicates found at dir1 (first parameter)
  103. /Kill2      delete duplicates found at dir2 (first parameter)
  104.  
  105. Do not use both options together!
  106. Warning: When using /N and not option /C together with a kill option
  107. then files are also deleted when files have equal name but not identical
  108. size and content!
  109.  
  110. [7] examples
  111.  
  112. example: show usage
  113.  
  114. finddbl
  115. usage: finddbl [/S][/C][/N] dir1[\[filter]] [dir2][\[filter]]
  116. dir1,dir2:  path of directories to compare (default dir2 is .)
  117. filter:     unix wildcards *,?,[a-z] can be used (default is *.*)
  118. /S:         find duplicate files in subdirectories
  119. /C:         match file content
  120. /N:         match file name
  121. /V:         show version
  122. default options: /C
  123.  
  124. example: show program version
  125.  
  126. finddbl /V
  127. finddbl v1.1 by Günter Nagler (Aug 10 1996)
  128. usage: finddbl [/S][/C][/N] dir1[\[filter]] [dir2][\[filter]]
  129. dir1,dir2:  path of directories to compare (default dir2 is .)
  130. filter:     unix wildcards *,?,[a-z] can be used (default is *.*)
  131. /S:         find duplicate files in subdirectories
  132. /C:         match file content
  133. /N:         match file name
  134. /V:         show version
  135. default options: /C
  136.  
  137. example: find duplicates in two special directories
  138.  
  139. finddbl c:\dir1  c:\dir2
  140. equal: C:\DIR1\FILENAME.EXT C:\DIR2\OTHER.DAT
  141.  
  142.  
  143. example: find duplicate midi files in a midi archive
  144.  
  145. finddbl /S *.mid g:\midi\*.mid
  146. equal: C:\NEW\MAGFLT13.MID G:\MIDI\MAGFLT13.MID
  147. equal: C:\NEW\MEDICINE.MID G:\MIDI\MEDICINE.MID
  148. equal: C:\NEW\BALLADE.MID G:\MIDI\BALLADE.MID
  149. equal: C:\NEW\BADNAME.MID G:\MIDI\BADNAME.MID
  150. equal: C:\NEW\REVIND1.MID G:\MIDI\REVIND1.MID
  151. equal: C:\NEW\PRAYER.MID G:\MIDI\PRAYER.MID
  152. equal: C:\NEW\RUNAWAY.MID G:\MIDI\RUNAWAY.MID
  153. equal: C:\NEW\ALWAYS.MID G:\MIDI\ALWAYS3.MID
  154.  
  155. A file C:\NEW\SPRING.MID that has other content than G:\MIDI\SPRING.MID
  156. and is therefore not shown.
  157.  
  158. example: delete duplicate files that are already in midi archive
  159. (be careful:  it is your responsibility!)
  160.  
  161. finddbl /Kill1 /S *.mid g:\midi\*.mid
  162. equal: C:\NEW\MAGFLT13.MID G:\MIDI\MAGFLT13.MID
  163. C:\NEW\MAGFLT13.MID killed.
  164. equal: C:\NEW\MEDICINE.MID G:\MIDI\MEDICINE.MID
  165. C:\NEW\MEDICINE.MID killed.
  166. equal: C:\NEW\BALLADE.MID G:\MIDI\BALLADE.MID
  167. C:\NEW\BALLADE.MID killed.
  168. equal: C:\NEW\BADNAME.MID G:\MIDI\BADNAME.MID
  169. C:\NEW\BADNAME.MID killed.
  170. equal: C:\NEW\REVIND1.MID G:\MIDI\REVIND1.MID
  171. C:\NEW\REVIND1.MID killed.
  172. equal: C:\NEW\PRAYER.MID G:\MIDI\PRAYER.MID
  173. C:\NEW\PRAYER.MID killed.
  174. equal: C:\NEW\RUNAWAY.MID G:\MIDI\RUNAWAY.MID
  175. C:\NEW\RUNAWAY.MID killed.
  176. equal: C:\NEW\ALWAYS.MID G:\MIDI\ALWAYS3.MID
  177. C:\NEW\ALWAYS.MID killed.
  178.  
  179. example: find files with identical filenames, don't care of their content
  180.  
  181. finddbl /S /N c:\dir1  c:\dir2
  182. equal: C:\NEW\MAGFLT13.MID G:\MIDI\MAGFLT13.MID
  183. equal: C:\NEW\MEDICINE.MID G:\MIDI\MEDICINE.MID
  184. equal: C:\NEW\BALLADE.MID G:\MIDI\BALLADE.MID
  185. equal: C:\NEW\BADNAME.MID G:\MIDI\BADNAME.MID
  186. equal: C:\NEW\REVIND1.MID G:\MIDI\REVIND1.MID
  187. equal: C:\NEW\PRAYER.MID G:\MIDI\PRAYER.MID
  188. equal: C:\NEW\RUNAWAY.MID G:\MIDI\RUNAWAY.MID
  189. equal: C:\NEW\SPRING.MID G:\MIDI\SPRING.MID
  190.  
  191. The file C:\NEW\SPRING.MID is shown as duplicate to G:\MIDI\SPRING.MID
  192. even if the file has other content.
  193.  
  194. example: find duplicate files with identical filenames
  195.  
  196. finddbl /S /C /N *.mid g:\midi\*.mid
  197. equal: C:\NEW\MAGFLT13.MID G:\MIDI\MAGFLT13.MID
  198. equal: C:\NEW\MEDICINE.MID G:\MIDI\MEDICINE.MID
  199. equal: C:\NEW\BALLADE.MID G:\MIDI\BALLADE.MID
  200. equal: C:\NEW\BADNAME.MID G:\MIDI\BADNAME.MID
  201. equal: C:\NEW\REVIND1.MID G:\MIDI\REVIND1.MID
  202. equal: C:\NEW\PRAYER.MID G:\MIDI\PRAYER.MID
  203. equal: C:\NEW\RUNAWAY.MID G:\MIDI\RUNAWAY.MID
  204.  
  205. the file C:\NEW\ALWAYS.MID with identical content as G:\MIDI\ALWAYS3.MID
  206. is not shown because the name ALWAYS.MID is different to ALWAYS3.MID
  207.  
  208. [8] SUGGESTIONS / COMMENTS / BUG REPORTS
  209.  
  210.          WWW:    http://hgiicm.tu-graz.ac.at/Cpub
  211.          EMAIL:  gnagler@ihm.tu-graz.ac.at
  212.  
  213. [9] CHANGES
  214. v1.0 to v1.1:
  215.   - new option /N to match filenames
  216.   - new option /C to match file content
  217.   - fixed bug that did not compare files in hidden or system subdirectories
  218.